A Filosofia da "Arquivo como Verdade"
A base do OpenClaw é a Filosofia First-Markdown. Ao contrário dos sistemas tradicionais de IA de caixa-preta, o OpenClaw trata a configuração como documentação. Cada aspecto da existência de um agente — sua personalidade, suas capacidades e seus fluxos operacionais — é armazenado em arquivos Markdown legíveis por humanos. Isso garante que a "Fonte da Verdade" seja transparente, controlada por versão e facilmente editável por humanos e modelos de linguagem.
- SOUL.md: A identidade central e o compasso moral.
- SKILL.md: O manifesto que define o que o agente realmente pode fazer.
- AGENTS.md: O plano de engenharia para a orquestração multi-agente.
A Pilha de Infraestrutura Central
Para passar de arquivos estáticos para um agente vivo, o OpenClaw utiliza uma arquitetura backend robusta projetada para estabilidade e flexibilidade:
- Runtime do Agente: A sala de máquinas que gerencia a Fila de Canais. Ela garante que tarefas assíncronas sejam processadas sem causar Corrupção de Estado, mantendo Isolamento de Sessão durante cada interação.
- Gateway: O plano de controle que gerencia a identidade de rede e o roteamento de modelo. Atua como um escudo de segurança, mitigando riscos como Execução Remota de Código (RCE) na API WebSocket.
- Camada de Ferramentas: Uma interface modular onde o agente se conecta a funções externas, APIs e scripts locais definidos no manifesto de habilidades.
- Motor Independente de Modelo: O sistema não está preso a um único provedor. Pode alternar entre Claude, GPT ou modelos locais por meio do openclaw.json roteador.
- Superfícies e Canais: São os pontos de interação (interface web, terminal ou móvel) onde o agente se manifesta para o usuário.
Configuração: openclaw.json
{
"identidade_de_rede": "agente-01-alpha",
"roteamento_de_modelo": {
"primario": "anthropic/claude-3-opus",
"fall-back": "local/llama-3-8b"
},
"injecao_de_ambiente": {
"pass_segura": verdadeiro,
"politica": "prevenir_vazamento"
}
}
Digite um comando...
Questão 1
Por que o OpenClaw prioriza uma Filosofia First-Markdown?
Questão 2
Qual componente é responsável por prevenir a Corrupção de Estado durante tarefas multi-agente?
Desafio: Falha de Segurança
Mitigando riscos de RCE em canais públicos.
Cenário: Você está implantando um agente em um canal público do Discord. Percebe que o agente está tentando executar comandos de shell não verificados, criando um risco de RCE (Execução Remota de Código) risco.
Seguro
Como você usa o Gateway e o SKILL.md para segurar a infraestrutura?
Solução:
1. Nível do Gateway: Restrinja a porta da API WebSocket (18789) apenas ao tráfego local ou implemente tokens de autenticação rigorosos.
2. Nível do SKILL.md: Defina permissões estritas no metadado YAML da Camada de Ferramentas.
3. Nível de Instrução: Atualize o Funil de Filtragem de Seis Camadas no manifesto de habilidades para rejeitar qualquer string de comando que contenha operadores sensíveis de shell.
1. Nível do Gateway: Restrinja a porta da API WebSocket (18789) apenas ao tráfego local ou implemente tokens de autenticação rigorosos.
2. Nível do SKILL.md: Defina permissões estritas no metadado YAML da Camada de Ferramentas.
3. Nível de Instrução: Atualize o Funil de Filtragem de Seis Camadas no manifesto de habilidades para rejeitar qualquer string de comando que contenha operadores sensíveis de shell.